home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / librw / RWSlistCollectablesStack.z / RWSlistCollectablesStack
Encoding:
Text File  |  2002-10-03  |  8.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk((((3333CCCC++++++++))))                  RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk((((3333CCCC++++++++))))
  5.  
  6.  
  7.  
  8. NNNNaaaammmmeeee
  9.      RWSlistCollectablesStack - Rogue Wave library class
  10.  
  11. SSSSyyyynnnnooooppppssssiiiissss
  12.               // Smalltalk typedef:
  13.  
  14.  
  15.  
  16.               typedef RWSlistCollectablesStack Stack;
  17.           #include <rw/stackcol.h>
  18.           RWSlistCollectablesStack a;
  19.  
  20.  
  21.  
  22.  
  23. DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  24.      Class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk represents a restricted interface to class
  25.      RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss to implement a last in first out (LIFO) stack.  A
  26.      Stack is a sequential list for which all insertions and deletions are
  27.      made at one end (the beginning of the list).  Hence, the ordering is
  28.      determined externally by the ordering of the insertions.  Duplicates are
  29.      allowed. An object stored by RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk must inherit
  30.      abstract base class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee.  The virtual function iiiissssEEEEqqqquuuuaaaallll(((()))) (see
  31.      class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee) is required, to find a match between a target and an
  32.      item in the stack.  This class corresponds to the Smalltalk class SSSSttttaaaacccckkkk.
  33.  
  34. PPPPeeeerrrrssssiiiisssstttteeeennnncccceeee
  35.      Polymorphic
  36.  
  37. PPPPuuuubbbblllliiiicccc CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrrssss
  38.               RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk();
  39.  
  40.  
  41.      Construct an empty stack.
  42.  
  43.               RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk(RWCollectable* a);
  44.  
  45.  
  46.      Construct a stack with one entry aaaa.
  47.  
  48.               RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk(const RWSlistCollectablesStack& s);
  49.  
  50.  
  51.      Copy constructor.  A shallow copy of the stack ssss is made.
  52.  
  53. AAAAssssssssiiiiggggnnnnmmmmeeeennnntttt OOOOppppeeeerrrraaaattttoooorrrr
  54.               void
  55.           ooooppppeeeerrrraaaattttoooorrrr====(const RWSlistCollectablesStack& s);
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk((((3333CCCC++++++++))))                  RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk((((3333CCCC++++++++))))
  71.  
  72.  
  73.  
  74.      Assignment operator.  A shallow copy of the stack ssss is made.
  75.  
  76. PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrr FFFFuuuunnnnccccttttiiiioooonnnnssss
  77.               virtual void
  78.           aaaappppppppllllyyyy(RWapplyCollectable ap, void*);
  79.           virtual RWspace
  80.           bbbbiiiinnnnaaaarrrryyyySSSSttttoooorrrreeeeSSSSiiiizzzzeeee() const;
  81.           virtual void
  82.           cccclllleeeeaaaarrrr();
  83.  
  84.  
  85.      Inherited from class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss.
  86.  
  87.               virtual void
  88.           cccclllleeeeaaaarrrrAAAAnnnnddddDDDDeeeessssttttrrrrooooyyyy();
  89.           virtual RWBoolean
  90.           ccccoooonnnnttttaaaaiiiinnnnssss(const RWCollectable* target) const;
  91.  
  92.  
  93.      Inherited from class RRRRWWWWCCCCoooolllllllleeeeccccttttiiiioooonnnn.
  94.  
  95.               RWBoolean
  96.           ccccoooonnnnttttaaaaiiiinnnnssssRRRReeeeffffeeeerrrreeeennnncccceeee(const RWCollectable* e) const;
  97.           virtual size_t
  98.           eeeennnnttttrrrriiiieeeessss() const;
  99.  
  100.  
  101.      Inherited from class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss.
  102.  
  103.               virtual RWCollectable*
  104.           ffffiiiirrrrsssstttt() const;
  105.  
  106.  
  107.      Inherited from class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss.  Same as ttttoooopppp(((()))).
  108.  
  109.               virtual RWCollectable*
  110.           iiiinnnnsssseeeerrrrtttt(RWCollectable* c);
  111.  
  112.  
  113.      Inherited from class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss.  Same as ppppuuuusssshhhh(((()))).
  114.  
  115.               virtual RWClassID
  116.           iiiissssAAAA() const;
  117.  
  118.  
  119.      Redefined from class RRRRWWWWCCCCoooolllllllleeeeccccttttaaaabbbblllleeee to return ________RRRRWWWWSSSSLLLLIIIISSSSTTTTCCCCOOOOLLLLLLLLEEEECCCCTTTTAAAABBBBLLLLEEEESSSSSSSSTTTTAAAACCCCKKKK.
  120.  
  121.               virtual RWBoolean
  122.           iiiissssEEEEmmmmppppttttyyyy()const;
  123.  
  124.  
  125.      Inherited from class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk((((3333CCCC++++++++))))                  RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessssSSSSttttaaaacccckkkk((((3333CCCC++++++++))))
  137.  
  138.  
  139.  
  140.               virtual RWCollectable*
  141.           llllaaaasssstttt() const;
  142.  
  143.  
  144.      Inherited from class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss.  Returns the item at the bottom
  145.      of the stack.
  146.  
  147.               virtual size_t
  148.           ooooccccccccuuuurrrrrrrreeeennnncccceeeessssOOOOffff(const RWCollectable* target) const;
  149.           size_t
  150.           ooooccccccccuuuurrrrrrrreeeennnncccceeeessssOOOOffffRRRReeeeffffeeeerrrreeeennnncccceeee(const RWCollectable* e) const;
  151.  
  152.  
  153.      Inherited from class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss.
  154.  
  155.               virtual RWCollectable*
  156.           rrrreeeemmmmoooovvvveeee(const RWCollectable*);
  157.  
  158.  
  159.      Redefined from class RRRRWWWWSSSSlllliiiissssttttCCCCoooolllllllleeeeccccttttaaaabbbblllleeeessss.  Calls ppppoooopppp(((()))).  The argument is
  160.      ignored.
  161.  
  162.               RWCollectable*
  163.           ppppoooopppp();
  164.  
  165.  
  166.      Removes and returns the item at the top of the stack, or returns nnnniiiillll if
  167.      the stack is empty.
  168.  
  169.               void
  170.           ppppuuuusssshhhh(RWCollectable*);
  171.  
  172.  
  173.      Adds an item to the top of the stack.
  174.  
  175.               RWCollectable*
  176.           ttttoooopppp() const;
  177.  
  178.  
  179.      Returns the item at the top of the stack or nnnniiiillll if the stack is empty.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.